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Introduction 


This is post is similar to the one about building flutter but a bit different. Actually this one was written 
a few years prior to writing flutter version but just never got published. Since then some steps has 
changed and | moved to Java 11. But you if you still build with java 8 old build method is still 
surprisingly functional. 


So the idea is to build and APK file which then can be installed on an android phone without using 
gradle and doing each step “manually”. If you are building regular android apps with Java/Kotlin 
then this is pointless. But it has a bit more sense when you are building game like apps with C/C++. 
But the most important thing is just to learn how this build process is working, what are its parts and 
how they stack together. 


Here are the files that will be used: 


MainActivity.java 
AndroidManifest.xml 
activity_main.xml 
styles.xml 
android_handmade.cpp 


Building regular android app 


Let's start with building very small android app without any help of build tool. For the initial android 
build we need only 2 files: MainActivity.cpp, AndroidManifest.xml. These should be enough to build 
the apk. We will need one more file keystore.jks to build to sign the apk so that android will allow us 
to install the apk on the device. 


So first of all let's create a root project folder. Name it whatever you want. | will name it 
'handmade_native_android' and then cd into it. Inside that folder create these files: 


./AndroidManifest.xml 
la /MainActivity.java 
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We put MainActivity.java in Ijavalcom/hereket/handmade_native_android/ folder structure. java is the 
place where we put all our java code and comihereket/handmade_native_android/ just reflects our 
package name 'com.hereket.handmade_native_android”. 


These two should be enough to be and apk if we create Ul programmatically. But | want to add 
some resource files so that if you want to create Ul as usual or use resource files, you won't have to 
figure out it yourself. 


So for that let's add a little more files and folder. In the root folder of the project add a folder named 
tres”. Here we will put required android resources. Inside it lets create two more folders layout and 
values. And then two more files layout/activity_main.xml and values/styles.xml. 


My android SDK is installed here “lopt/Android/Sdk”. So for you own tests replace this path with the 
pass of android installation on your machine. Also in order to use android tools | added path the 
binaries to the path like this: 


export PATH="/opt/Android/Sdk/build-too1s/33.0.2:$PATH" 


We will need one more folder __ build. Put it in the root folder of the project. It is a temporary folder 
which will contain all temporary files needed for the compilation process. 


So let's start generating intermediate files. For that run the following command. It will create R.java. 
It will contain all the resources with their respective ids which will be used in our activity. The file will 
be created in in __ build/gen/... 


aapt package -f -mA 
-J] _ build/gen M 
-S res M 
-M AndroidManifest.xml A 
-1 "/opt/Android/Sdk/platforms/android-33/android.jar" 


The next we just compile MainActivity.¡ava and R.java into their object form. 


javac A 
-Classpath "/opt/Android/Sdk/platforms/android-33/android.jar" M 
-d "_ build/obj" Y 
"_ build/gen/com/hereket/handmade_native_android/R.java" Y 
java/com/hereket/handmade_native_android/MainActivity.java 


This command will create MainActivity.class, R.class and class files for inner classes of R.java. 
They will be placed in “__build/obj/...”. Now create *apk' folder inside *_ build” folder for the next 
step. In the next step let's dex all class files and merge all our class files into a my_classes,jar file. 


d8 _ build/obj/**/*.class M 
--output _ build/apk/my_classes.jar 
- -no-desugaring Y 


The ***/*. class” is expanded int a list of class files. If you have issues with this method just use find 
utility to find a list of all class file, put it into a varible and pass it instead. And now let's merge this 
and android.jar and create classes.dex file. lt is a merged 'dex' format file that can run on dalvik. 
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pushd __build/apk 

d8 M 
"/opt/Android/Sdk/platforms/android-33/android.jar" 
my_classes.jar 


popd 
So we got all the required files let's merge them into an apk. For that we again will use aapt: 


aapt package -f -M AndroidManifest.xml -S res M 
-1I "/opt/Android/Sdk/platforms/android-33/android.jar" A 
-F _ build/handmade_native_android.unsigned.apk Y 
__build/apk/ 


Yay. We got our an apk file named handmade_native_android.unsigned.apk inside __ build/apk/ 
folder. But we cannot run it on our device because we need a couple more steps in order to prepare 
itto to format that android actually accepts. The next step is to align apk and we can do with this 
command. 


zipalign -f -p4 M3 
__build/handmade_native_android.unsigned.apki 
__build/handmade_native_android.aligned.apk 


This will create a file name handmade_native_android.aligned.apk inside __build/apk. The last step 
is to sign the apk with our key. It is a required and android security system will not accept an apk 
without beign signed first. If you have your key you can just drop into the root folder with the name 
'keystore.jks' of this project or you just want to follow along just run this: 


keytool -genkeypair -keystore keystore.jks -alias androidkey Y 
-dname "CN=hereket.com, OU=ID, O=HEREKET, L=Abc, S=Xyz, C=GB" A 
-validity 10000 -keyalg RSA -keysize 2048 Y 
-storepass android -keypass android 


So after you copied key or generated key we can need to sign the apk. 


apksigner sign --ks keystore.jks A 
--ks-key-alias androidkey 
--ks-pass pass:android 
--key-pass pass:android * 
--out _ build/handmade_native_android.apk Y 
__build/handmade_native_android.aligned.apk 


And here created a file handmade_native_android.apk. This is a final apk that could be run a device. 


Adding JNI support 


We have achieve our goal of creating a runnable apk but let's add a little bit of JNI support. It is not 
required. 


For this to work let's first and some code. Inside the root folder add “jni' folder and inside of it add a 
file named android_handmade.cpp . 
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In order for the JNI actually do something that we can see let's change our MainActivity.java file 
slightly to actually call JNI code. You can see the new code here: New MainActivity.¡ava 


ARMV7="/opt/Android/Sdk/ndk/r25b/too1chains/11vm/prebuilt/linux-x86_64/bin/armv7a-linux 
MY_LOCAL_LDFLAGS='-1jnigraphics -1lo0g -landroid' 
CFLAGS="-g -00 -fPIC -shared -static-libstdc++" 


"$LARMV7)" $CFLAGS 
-0o __build/apk/lib/armeabi-v7a/libandroid_handmade.so A 


jni/android_handmade.cpp A 
$MY_LOCAL_LDFLAGS 


Here we just create a shared library named libandroid_handmade.so inside 

* _ build/apk/lib/armeabi-v7a”. In reality | should have create a separate shared library for 64 bit arm 
and maybe a version for x86 but since | am targetting just android and 64 bit arm can execute 32 bit 
code | can just skip those steps. 


So now we have to redo all the steps above starting from the place where are starting to create 
apk, align and sign it. After that we should have an apk that is using C/C++ code. 


As a result we will get this app. 
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Android app created from command line 


Conclusions 


In this article we created a fully functional apk that runs on a real device. The only reason to do so 
was to look at pieces used to create an apk and the processes used to put those pieces together. 


| do not recommend building real android apps using this way but you should try to do this process 
manually once just to get the grasp of what is happening in the build process. 


If you want to have a look at the full final project then go to the github page at 
https:/Igithub.com/hereket/handmade native android. 
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